Skip to content

ci: verify required release targets built and publish SHA256SUMS - #17

Merged
bougyman merged 2 commits into
mainfrom
issue-16
Aug 9, 2026
Merged

ci: verify required release targets built and publish SHA256SUMS#17
bougyman merged 2 commits into
mainfrom
issue-16

Conversation

@bougyman

@bougyman bougyman commented Aug 9, 2026

Copy link
Copy Markdown
Member

Summary

Closes #16.

No Homebrew tap exists yet (CRY-37), so the GitHub Release binaries are the primary install path for a lot of users right now, not a fallback. Two real gaps in burrito-release.yaml:

  • No completeness guarantee: mix release lc builds all 3 Burrito targets in one invocation, and Burrito builds each target independently, so one target failing partway through wouldn't necessarily fail the whole mix release invocation - the release could ship missing a binary with no CI signal. Now explicitly verifies lc_linux_x86_64 and lc_macos_aarch64 exist post-build, failing loudly (::error::) if either is missing - the guaranteed floor. Windows keeps building for free (the step already installs p7zip for it) but isn't asserted on.
  • No integrity verification: nothing let a downloader confirm a binary wasn't corrupted or tampered with in transit. Now generates a SHA256SUMS file covering every artifact that actually built, uploaded alongside the binaries.
  • Readme.adoc's "Download a release binary" section documents verification on both platforms - shasum -a 256 -c - on macOS (stock macOS has no sha256sum), sha256sum -c - on Linux.

Test plan

  • Validated the updated workflow YAML parses correctly (ruby -ryaml)
  • Manually reproduced the checksum generate+verify flow against real built binaries (app/burrito_out/lc_macos_aarch64/lc_linux_x86_64) - confirmed shasum -a 256 -c - and sha256sum -c - both correctly verify a grep'd SHA256SUMS line
  • Caught and fixed a real bug in my own first draft of the Readme example: verification has to happen against the binary's original downloaded filename, before renaming/moving it, or shasum -c fails looking for a file that no longer exists under that name
  • Readme.adoc still renders cleanly (asciidoctor -o /dev/null)
  • Next real release should show the new "Verify the required targets actually built" step passing and a SHA256SUMS asset attached

🤖 Generated with Claude Code

No Homebrew tap exists yet (CRY-37), so the GitHub Release binaries are
the primary install path for a lot of users right now, not a fallback.
Two real gaps: `mix release lc` builds all 3 Burrito targets in one
invocation and Burrito builds each independently, so one target could
silently fail without failing the whole build - the release could ship
missing a binary with no CI signal. And nothing let a downloader verify
a binary wasn't corrupted or tampered with in transit.

Explicitly verify lc_linux_x86_64 and lc_macos_aarch64 exist post-build,
failing loudly (::error::) if either is missing - the guaranteed floor.
Windows keeps building for free but isn't asserted on. Generate a
SHA256SUMS file covering every artifact that did build, uploaded
alongside the binaries. Readme.adoc documents verification on both
platforms - shasum -a 256 -c - on macOS (no sha256sum on stock macOS),
sha256sum -c - on Linux.

Closes #16.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 9, 2026 20:54

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR strengthens the release pipeline by ensuring required Burrito release targets are actually produced before uploading, and by publishing a SHA256SUMS asset so users can verify downloaded binaries.

Changes:

  • Add an explicit CI verification step to fail the workflow if required artifacts (lc_linux_x86_64, lc_macos_aarch64) are missing after mix release lc.
  • Generate and upload a SHA256SUMS file alongside built release artifacts.
  • Update Readme.adoc to document checksum verification for release binary downloads.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
.github/workflows/burrito-release.yaml Adds post-build target existence checks and generates/uploads a SHA256SUMS file with the release artifacts.
Readme.adoc Documents downloading SHA256SUMS and verifying the macOS binary checksum before installing/renaming.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread Readme.adoc
Comment on lines +47 to +51
$ curl -sLO https://github.com/rubyists/linear-cli-ex/releases/latest/download/lc_macos_aarch64
$ curl -sLo SHA256SUMS https://github.com/rubyists/linear-cli-ex/releases/latest/download/SHA256SUMS
$ grep lc_macos_aarch64 SHA256SUMS | shasum -a 256 -c - <1>
$ chmod +x lc_macos_aarch64
$ sudo mv lc_macos_aarch64 /usr/local/bin/lc
A grep miss piping empty input into the checker isn't safe to skip -
sha256sum -c - (the Linux equivalent) exits 0 on empty input, so a
typo'd filename would silently "pass" without checking anything at
all. Guard with grep -q ... && first. Also trims the accompanying
footnote back down to the platform-command difference alone - the
rationale belongs here in the commit message, not as an implementation
essay in the Readme itself.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@bougyman
bougyman merged commit 7484e09 into main Aug 9, 2026
2 checks passed
@bougyman
bougyman deleted the issue-16 branch August 9, 2026 21:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Release artifacts need integrity verification and a build completeness guarantee

2 participants